home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / sm103.zip / MAIL.TXT < prev    next >
Text File  |  1996-07-29  |  6KB  |  212 lines
  1. Stalker's SMTP Mailer V1.03      07.29.96 / Eric Voisard
  2. ========================================================
  3.  
  4. Copyright (c) Stalker Lab (SaRL), Switzerland
  5. All Rights Reserved.
  6.  
  7. S T A L K E R  SaRL
  8. Jaquet-Droz 18
  9. 2300 La Chaux-de-Fonds
  10. Switzerland
  11.  
  12. phone: +41 39 225 666
  13. fax: +41 39 225 667
  14. email: tech@cdf.globalcafe.ch (soon: tech@stalker.ch)
  15.  
  16.  
  17. Stalker's SMTP Mailer is freeware and can be freely distributed.
  18. The Software is provided on an "AS IS" basis, without warranty of any
  19. kind. Eric Voisard and Stalker Lab decline any responsability in the
  20. eventuality of damages caused by the use of this software.
  21.  
  22.  
  23.  
  24. INTRODUCTION
  25. ------------
  26.  
  27. Stalker's SMTP Mailer is a simple mail sender (not receiver) to use
  28. from command prompt. It was written for use in conjunction with CGI
  29. scripts. It has a command line syntax similar to BSD UNIX and then
  30. minor changes will be needed to port UNIX scripts on NT.
  31.  
  32. Stalker's SMTP mailer is MIME compliant (useful for countries other
  33. than US!).
  34.  
  35. As a 32bits app, it requires Microsoft Windows 95 or (better)
  36. Windows NT.
  37.  
  38.  
  39.  
  40. INSTALLATION
  41. ------------
  42.  
  43. Put mail.exe in any directory, and mail.ini in the Windows directory.
  44. Program location can be appended to the PATH environment variable in
  45. order to run mail.exe from other directories.
  46. An optional environment variable can be added to override the search of
  47. mail.ini in Windows directory and the writing of output files in the
  48. current one:
  49.  
  50. SET SM=C:\WIN32APP\MAIL
  51.   
  52. This allows a multiusers configuration:
  53.  
  54. SET SM=C:\USERS\%USERNAME%\MAIL
  55.  
  56. Note: on NT, this line must be added in .\system32\autoexec.nt, not in
  57. c:\autoexec.bat.
  58.  
  59. To find mail.ini, Mail.exe first checks if there is a SET variable,
  60. afterwhat it checks current directory, and finally it checks Windows
  61. directory.  
  62.  
  63.  
  64. SYNTAX
  65. ------
  66.  
  67. mail [-s subject] [-c cc-addr] [-b bcc-addr] to-addr...
  68.  
  69. -s subject
  70. Specifie subject on command line (only the first argument after
  71. the -s flag will be used as a subject; be careful to quote ("...")
  72. subjects containing spaces.)
  73.  
  74. -c cc-addr
  75. Send Carbon-copies (Cc:) to a comma-separated list of recipients.
  76.  
  77. -b bcc-addr
  78. Send Blind-carbon-copies (Bcc:) to a comma-separated list of recipients.
  79.  
  80. to-addr
  81. Send mail (To:) to a list of recipents. Must be at the end of command
  82. line, and at least one is needed.
  83.  
  84. You can specifie up to 100 recipients at all.
  85.  
  86.  
  87.  
  88. SENDING MAIL
  89. ------------
  90.  
  91. To send a message to one or more people, mail can be invoked with
  92. arguments which are the names of people to whom the mail will be send.
  93. Yo are then expected to type in your message followed by an <ctrl-Z>.
  94.  
  95. Some command lines examples are:
  96.  
  97. mail -s "My subject" -c riri@stalker.ch,fifi@stalker.ch loulou@stalker.ch
  98. (two Cc: recipients plus one To: recipient)
  99.  
  100. mail -s "My subject" -c riri@stalker.ch fifi@stalker.ch loulou@stalker.ch
  101. (one Cc: recipients plus two To: recipients)
  102.  
  103. mail -s "My subject" -c riri@stalker.ch -b fifi@stalker.ch loulou@stalker.ch
  104. (one Cc: recipient, plus one Bcc: recipient plus one To: recipient)
  105.  
  106.  
  107. Instead of manually enter your mail body, you can do pipes or files
  108. redirections, this is useful for CGIs:
  109.  
  110. mail -s "My subject" voisard@dial.eunet.ch < body.txt > process.log
  111. (will use the file body.txt as mail body, and will verbose the process
  112. to a log file)
  113.  
  114. echo BodyBuffer ª mail -s "My subject" voisard@dial.eunet.ch > process.log
  115. (will take the output of echo as mail body, and will verbose the
  116. process to a log file)
  117.  
  118. There is no limit with body size, but each line can't be longer than
  119. 1000 chars and MUST be ended with CR/LF (Carriage-Return and Line-Feed).
  120. Note that UNIX style (LF alone) will work, but Macintosh type (CR
  121. alone) will not.
  122.  
  123.  
  124.  
  125. ERRORS
  126. ------
  127.  
  128. The output of mail verboses all the sending process. 
  129. If the mail message was present before an error occured, or if the
  130. mail was not or partially sent for any reason, it is appended to the
  131. file dead.letter.txt. So it is possible to handle it manually as a last
  132. resort.
  133.  
  134.  
  135.  
  136. Mail.ini
  137. --------
  138.  
  139. Some setting must be specified in the mail.ini:
  140.  
  141. Gateway=
  142. Name of the SMTP relay
  143.  
  144. Sender=
  145. Email address of the sender which will appear in the "From:" field of
  146. the mail header. 
  147.  
  148. Realname=
  149. Real name of the sender which will also appear in the "From:" field of
  150. the mail header.
  151.  
  152. MIMEncode=
  153. This is a MIME encoding parameter. Stalker's Mailer uses MIME specs
  154. declarations and encoding.
  155. If MIMEncode=no, mail will be sent 8bits MIME to the mail relay without
  156. encoding.
  157. If MIMEncode=yes, mail will be sent 7bits Quoted-printable MIME encoded.
  158. This setting depends on the mail relay capabilities to handle 8bits
  159. chars, but it is more reliable to force 7bits encoding.
  160.  
  161. Charset=
  162. Specifies the local charset used (e.g. US = us-ascii; Latin = iso-8859-1)
  163.  
  164.  
  165.  
  166. REFERENCES
  167. ----------
  168.  
  169.  [1] J. Postel,
  170. "SMTP (Simple Mail Transfert Protocol)", RFC 821,  ISI, August 1982
  171.  
  172.  [2] Crocker, D.,
  173. "Standard for the Format of ARPA Internet Text Messages", STD 11,
  174. RFC 822, UDEL, August 1982.
  175.  
  176.  [3] Borenstein N., and N. Freed
  177. "MIME (Multipurpose Internet Mail Extensions)
  178. Part One:  Mechanisms for Specifying and Describing the Format of
  179. Internet Message Bodies", RFC 1521, Bellcore, Innosoft, September 1993.
  180.  
  181.  [4] K. Moore
  182. "MIME (Multipurpose Internet Mail Extensions)
  183. Part Two: Message Header Extensions for Non-ASCII Text", RFC 1522,
  184. University of Tennessee, September 1993.
  185.  
  186.  
  187.  
  188. HISTORY
  189. -------
  190.  
  191. 07.29.96    Version 1.03
  192. -Modified the code so that mail.exe checks for mail.ini in
  193. current directory, and in Windows directory.
  194. -Added SM environment variable to allow multiuser config.
  195. -Added a date stamp on messages appended to dead.letter.txt for better
  196. management.
  197.  
  198.  
  199. 07.24.96    Version 1.02
  200. -Improved the MIME conversion routine.
  201.  
  202. 07.10.96    Version 1.01
  203. -Fixed minor bug causing inappropriate error message.
  204. -Changed a test causing the sending (RCPT TO) of recipient list
  205. to be stopped a first incorrect one, and mail to be unsent to
  206. remaining correct recipients. Now, all valid recipients will
  207. receive their mail.
  208.  
  209. 06.25.96    Version 1.00
  210. -First release
  211.  
  212.